home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / manage / gtree.arc / README < prev   
Text File  |  1988-03-17  |  7KB  |  398 lines
  1.  
  2.                          GTREE and HUNT
  3.  
  4.                           Introduction
  5.  
  6.  
  7. There are two programs contained here, HUNT and GTREE.  HUNT is
  8. used to locate a file anywhere on a disk that contains
  9. subdirectories.  GTREE will print a graphical representation of
  10. the tree structure of a disk.
  11.  
  12. Source code for both programs is included in this archive.  These
  13. programs were written using Turbo C version 1.5 by Borland
  14. International.  They will compile without any problems using this
  15. compiler.  The command line syntax used was TCC -w -A.  These
  16. programs will compile and run correctly with the -d and -G flags
  17. although little time and space will be saved.
  18.  
  19. If you decide to change either program, you had best be aware
  20. that there are some things to be aware of.  Both program have a
  21. function named buildtree() and GTREE has a function named
  22. print_tree().  These are recursive.  Be careful with any changes
  23. you may make.
  24.  
  25. Since there is always the possibility of stack overflow with
  26. recursive functions, both programs have increased the stack size
  27. of 32768 bytes.  You are free to lower this number if needed, but
  28. this should be no problem.  Both will run with the standard stack
  29. size of 4096 bytes on a 20 meg harddisk with 61 directories and
  30. subdirectories.  This is just above as many as I have ever seen,
  31. so I don't expect anyone to have a problem there.
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                             PAGE - 1-
  67.  
  68.                          GTREE and HUNT
  69.  
  70.                 Licensing, Support And Copyright
  71.  
  72.  
  73. These programs are the property of D. M. Software And Systems.
  74. They are being released as described in this documentation for
  75. the convenience of the general public, not for resale or use in a
  76. corporate or governmental environment.
  77.  
  78. These programs are to be considered "Shareware".  This means that
  79. you are free to use this program as you see fit.  However, you
  80. are asked to send $20.00 to help support this program.  This fee
  81. will also entitle you to one free upgrade and some technical
  82. support.  Information will also be provided on other programs
  83. released by D. M. Software And Systems if requested.
  84.  
  85. You are also free to copy these programs, including the source,
  86. and redistribute them, as long as no fee is charged for this
  87. service and none of the copyright notices that appear either in
  88. the code, or at runtime are changed.
  89.  
  90. No support will be provided for unregistered users.  Those that
  91. have sent their $20.00 registration fee can contact D. M.
  92. Software And Systems by phone at (314) 296-4719.  Sorry, but no
  93. collect calls can be accepted.
  94.  
  95. Since D. M. Software And Systems is a one man consulting and
  96. contracting firm, it will not always be possible to get telephone
  97. support.  However, if your problem is not urgent, you can write
  98. to:
  99.  
  100.               D. M. Software And Systems
  101.               6572 Suson Woods Drive
  102.               St. Louis, MO  63128
  103.  
  104. Those of you who have a subscription to Compuserve can leave a
  105. message via Easyplex to user ID 71251,3121.  In either case,
  106. please make sure to give me a complete description of your
  107. problem, the program you are using, the version number, your
  108. serial number, and how you can be reached once your problem has
  109. been resolved.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                             PAGE - 2-
  133.  
  134.                          GTREE and HUNT
  135.  
  136.                            GTREE Usage
  137.  
  138.  
  139. GTREE is an easy to use program that will print a graphical
  140. representation of your disk's tree structure.  As such, it has
  141. only to command line parameters, the drive number and the ability
  142. to change the characters used to print the connectors in the
  143. tree.  Correct usage is:
  144.  
  145.               GTREE [drive:] [-G]
  146.  
  147. If the drive specification is not present, the current drive is
  148. used.  Normally this is the case.
  149.  
  150. -G changes the characters used for connectors in the tree.  It
  151. can be specified as either upper or lower case, and can be before
  152. or after the drive designation.  There is no reason to use this
  153. switch on any tree printed on the screen.  This option is for
  154. printers that cannot print any of the characters in the PC's
  155. graphics character set.  If your print will print the normal box
  156. on the last page of this document, there is no need for this
  157. option.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                             PAGE - 3-
  199.  
  200.                          GTREE and HUNT
  201.  
  202.                            HUNT Usage
  203.  
  204.  
  205. HUNT is an easy way to find a file, or list of files, anywhere on
  206. a disk.  Like GTREE, there are few command line options.  Correct
  207. syntax is:
  208.  
  209.               HUNT filespec [filespec] [-H] [-K] [-V]
  210.  
  211. More than one file specification can be present on a command
  212. line.  If this happens, then each directory will be search once
  213. for each specification found.
  214.  
  215. -H is used to display the usage message.
  216.  
  217. -K is used to "Kill" files.  All matching files will be deleted,
  218. after operator verification.
  219.  
  220. -V "preverifies" the deletion request.  For example, when I go to
  221. backup my harddisk, I type "HUNT *.BAK -k -v".  All .BAK files
  222. are automatically deleted.
  223.  
  224. All flags and file specifications can be specified in any order.
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.                             PAGE - 4-
  265.  
  266.                          GTREE and HUNT
  267.  
  268.                            HUNT Usage
  269.                  Registration For GTREE and HUNT
  270.  
  271. Please fill out the form below and return:
  272.  
  273.               D. M. Software And Systems
  274.               6572 Suson Woods Drive
  275.               St. Louis, MO 63128
  276.  
  277. Signing this form means you have read the license and
  278. distribution requirement, understand them, and agree to follow
  279. them.
  280.  
  281. Corporate and Govermental users please contact D. M. Software And
  282. Systems at (314) 296-4719 for current site licensing
  283. arrangements.
  284.  
  285. You will be mailed a verification along with your serial number
  286. upon receipt of this form.  Registration entitles you to one free
  287. upgrade, either to the current version on receipt of this form,
  288. or to the next version.
  289.  
  290.  
  291. Please make checks payable to D. M. Software And Systems.
  292. Registration is $20.00 payable in U.S. funds.  Outside the United
  293. States, please add $2.00 for exchange.
  294.  
  295.  
  296.  
  297.  
  298. Name     ______________________________________________
  299.  
  300.  
  301. Address  ______________________________________________
  302.  
  303.  
  304. City     ______________________________________________
  305.  
  306.  
  307. State    ______   Zip Code ____________________________
  308.  
  309.  
  310.  
  311. Signature _____________________________________________
  312.  
  313. Product GTREE and HUNT version 1.00
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.                             PAGE - 5-
  331.  
  332.                          GTREE and HUNT
  333.  
  334.                            HUNT Usage
  335.                        Sample For Printer
  336.  
  337. This is the sample boxes for testing your printer.  If the second
  338. box prints, then you do not need to use the -g switch with GTREE.
  339.  
  340.  
  341.     Text Box       +-+
  342.                    | |
  343.                    +-+
  344.  
  345.  
  346.     Graphics Box   ┌─┐
  347.                    │ │
  348.                    └─┘
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.                             PAGE - 6-
  397.  
  398.